home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-2.iso / Files II / Newton / Programming / Unistrokes.sit / Unistrokes ƒ / README.Unistrokes / README.Unistrokes
Encoding:
Text File  |  1994-10-10  |  3.8 KB  |  144 lines  |  [TEXT/MPS ]
  1. README.Unistrokes
  2. -----------------
  3.  
  4. This file describes a development version of a Unistrokes recognizer for
  5. the Newton computer.
  6.  
  7.  
  8. Description
  9. -----------
  10.  
  11. This program was written to test the feasibility of Unistroke recognition
  12. on the current generation of Newton PDAs and to collect data on the
  13. perfomance of the Newton in stroke collection and recognition.  It
  14. has no other intended utility.  Read the Caveats section.
  15.  
  16. Information on Unistrokes
  17. -------------------------
  18. FTP: ftp.parc.Xerox.COM
  19. Directory: /pub/unistrokes
  20. Purpose: Public documentation for the unistrokes stylus system.
  21. Maintainer: David Goldberg <goldberg@parc.xerox.com>
  22.  
  23.  
  24. Screen Layout
  25. -------------
  26.  
  27. The screen layout of this program from top to bottom has the following
  28. elements:
  29.  
  30. ++ Title:
  31. -- The name of the application "Unistrokes Testbed".
  32.  
  33. ++ Recognized text:
  34. -- A line of text beginning with a ">" character which accumulates characters
  35. recognized within the "Recognition rectangle".  If a stroke is detected
  36. but not recognized either a '*' or '#' will be placed (which depends on
  37. internal details of recognizer).
  38.  
  39. ++ Recognition rectangle:
  40. -- The area in which to make a unistroke for recognition.  The unistroke
  41. needs to be made entirely within this rectangle.
  42.  
  43. ++ Shift button:
  44. -- A check box button, which when tapped will cause the next character
  45. recognized to be capitalized.
  46.  
  47. ++ Statistics area:
  48. -- Two lines of text.  When the program starts, the first line has a
  49. version number followed by build date and time, while the second line
  50. has a copyright notice.  These are cleared when the first stroke is
  51. detected in the "Recognition rectangle", unless the "Show Statistics"
  52. button is checked.
  53.  
  54. An example of statistics display:
  55. 37 177 79 203,ink:8,pnts:30,ticks:15
  56. (r)
  57.  
  58. 37 177 79 203
  59. -> first and last X, first and last Y coordinates.
  60.  
  61. ink:8
  62. -> the stroke took about 8 twentieths of a second to write.
  63.  
  64. pnts:30
  65. -> a total of 30 points returned by the Newton
  66.          for the stroke.
  67.          
  68. ticks:15
  69. -> the recognition algorithm took 15/60 seconds.
  70.  
  71. (r)
  72. -> an 'r' was recognized.
  73.  
  74. ++ Erase button:
  75. -- Resets the "Recognized text" line to ">".
  76.  
  77. ++ Show Statistics button
  78. -- Causes statistics to show up in "Statistics area".
  79.  
  80.  
  81. Caveats:
  82. --------
  83.  
  84. * Not well tested.
  85.  
  86. * Truncates strokes taking longer than 1.5 seconds.  Sometimes will recognize
  87.   them, but unlikely for complex strokes.
  88.  
  89. * Sometimes misses on quick strokes, especially small ones.  Try an 'X'
  90.   with a small, quickly drawn loop - it sometimes sees a 'V'.
  91.  
  92. * Only the author's strokes have been seen.
  93.  
  94. * Only tested on Newton MP 100, not MP 110.
  95.  
  96. * No doubt other problems exist.
  97.  
  98.  
  99. Comments on findings:
  100. ---------------------
  101.  
  102. The Newton with interpreted NewtonScript is too slow to do a
  103. point by point feature extraction on the collected points, so the
  104. strokes were sampled about every 50 ms., leading to a lack of
  105. robustness on quick, complex stokes.  On most strokes it did OK.
  106. Your mileage may vary.
  107.  
  108. Apple is promising a faster code generator for NewtonScript and
  109. perhaps a C compiler, but with no time frame.  At that time I may
  110. try again.
  111.  
  112.  
  113. Legal stuff
  114. -----------
  115.  
  116. This program is Copyright © 1994 by James Thiele. It may be distributed
  117. freely as long as the program is unmodified and is accompanied by this
  118. README file.
  119.  
  120. Because there are too many lawyers in the world, I add the following
  121. statement:
  122.  
  123. This program is made available without any claim that it is suitable for
  124. any use.  The author's liability is limited to what was charged for it
  125. which was nothing.  It works OK on my MessagePad 100,
  126. but I am not making any other statements of other systems it could or
  127. should run on.
  128.  
  129.  
  130. Author
  131. ------
  132.  
  133. You can let the author know what you think of this prgram by contacting him 
  134. at:
  135.  
  136. James Thiele
  137. jet@eskimo.com
  138. 73537,1460     on Compuserve (checked rarely)
  139. JET1           on AOL        (checked rarely)
  140.  
  141. 8217 5th Ave NE, #303
  142. Seattle, WA  98115
  143.  
  144. (Addresses valid as of October 1994)